home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / health / rms_v160.zip / README.TXT < prev    next >
Text File  |  1996-01-01  |  20KB  |  473 lines
  1.                        Recipe Management System Version 1.60
  2.                                   Shareware Guide
  3.  
  4.          !!!!!!! THANK-YOU FOR TRYING THE RECIPE MANAGEMENT SYSTEM !!!!!!!!
  5.          The Recipe Management System is a shareware program written by Jon
  6.          T.  McEwen. After  trying it  for  60  days if  you would  like to
  7.          continue using  it, please register  your copy with  me by sending
  8.          $30.00 (U.S. funds) along with your name and address to:
  9.  
  10.                              Jon T. McEwen
  11.                              P.O. Box 15619
  12.                              Seattle, Washington 98115-0619
  13.  
  14.          If you  are a CompuServe  subscriber, you can  register on-line by
  15.          typing GO SWREG. The registration ID for RMS is 8689.
  16.  
  17.          When  you do,  I will  send you  a users'  guide and  a letter  of
  18.          registration  that will  provide you  with instructions  on how to
  19.          turn  off the  startup screen,  disable delays,  and allow  you to
  20.          directly import Meal-Master recipes.  Please distribute the Recipe
  21.          Management  System to  your friends  and colleagues.  When you do,
  22.          please make  sure you give them  the original self-extracting file
  23.          (RMS_V160.EXE) or, copies of the following files:
  24.  
  25.                      RECIPE.EXE   main program file
  26.                      RECIPE.DAT   main database file
  27.                      RECIPE.IX    database index file
  28.                      RECIPE.CAT   recipe category list
  29.                      RECIPE.CFG   configuration file
  30.                      README.TXT   this file
  31.                      EPSON.PDF    Epson style Printer Definition File
  32.                      EPSON3X5.PDF Epson PDF for printing on 3x5 cards
  33.                      HPLASER.PDF  HP LaserJet Printer Definition File
  34.                      HPL3X5.PDF   HP LaserJet for printing 3x5 cards on
  35.                                   regular 8.5 x 11 paper
  36.                      HP3X5BOX.TXT reset file, draws 3x5 boxes on laser
  37.  
  38.          The  Recipe Management  System (RMS)   is the  easiest way  yet to
  39.          store,  retrieve  and  share  your  recipes  using  your  Personal
  40.          Computer.  RMS  features   include:  character  oriented  windows,
  41.          context  sensitive  pop-up  help,  full  mouse  support and a full
  42.          featured editor for easy formatting  of preparation text. The main
  43.          difference  between  RMS  and  other  Recipe  programs is the user
  44.          interface. When you start up RMS it goes straight into the browser
  45.          where you can  scroll through all of your recipes  in one of three
  46.          orders,  Recipe Name,  Category or  Main Ingredient.  You can find
  47.          recipes by entering search criteria in any of the fields (multiple
  48.          fields  too) or  tell it  to only  browse recipes  that satisfy  a
  49.          search criteria (called a Filter). The  keys you use to browse are
  50.          the keys you're already used to, PgUp, PgDn, Up and Down arrows or
  51.          you can use  your mouse. When you find the  recipe you want, press
  52.          Enter  (or click  the mouse)  and you're  instantly in the editor.
  53.          From here  you can modify  serving sizes, quantities,  preparation
  54.          and more. To  get back to the browser,  press Ctrl+Enter. There is
  55.          much,  much  more  to  the  Recipe  Management  System, BE SURE TO
  56.          REGISTER YOUR  COPY so you can  get a copy of  the RMS Users Guide
  57.          and take full advantage of ALL that RMS has to offer!
  58.  
  59.                                       Page 1
  60.                              Recipe Management System
  61.                                   Shareware Guide
  62.  
  63.          REQUIREMENTS:
  64.          The  Recipe Management  System  has  the following  minimum system
  65.          requirements:  530k of  free conventional  memory, and  one meg of
  66.          free hard disk space (to install  on a hard drive). RMS should run
  67.          on any 100% compatible IBM PC under DOS or WINDOWS.
  68.  
  69.          CAPACITIES:
  70.          - Maximum cookbooks per directory;  215
  71.          - Maximum recipes per cookbook:     2,147,483,647 (theoretical)
  72.          - Maximum ingredients per recipe:   25
  73.          - Maximum preparation size (bytes): 4,096 (4K)
  74.          - Maximum number of categories:     50
  75.          - Maximum Printer Definition Files: 107
  76.  
  77.          INSTALLATION:
  78.          !!!!!!!!! NOTE TO THOSE UPGRADING FROM EARLIER VERSIONS !!!!!!!!!!
  79.          If  you want  to keep  any changes  you made  to the cookbook that
  80.          comes  with  RMS  (RECIPE)  DO  NOT  COPY  OVER  THE RECIPE.DAT OR
  81.          RECIPE.IX FILES! Version 1.60 will update the index file the first
  82.          time you open a cookbook from an earlier version.
  83.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  84.  
  85.          RMS_V160.EXE is  a self extracting compressed  file. Pass the name
  86.          of the subdirectory you want RMS installed in when you call it, or
  87.          run it from the subdirectory you want it installed in for example:
  88.  
  89.                  C:\>MD C:\RECIPE
  90.                  C:\>RMS_V160 C:\RECIPE
  91.  
  92.          If you have copies of the individual files listed above, just copy
  93.          them to the desired location on your hard drive for example:
  94.  
  95.                  C:\>MD C:\RECIPE
  96.                  C:\>COPY A:*.* C:\RECIPE
  97.  
  98.          STARTING THE PROGRAM:
  99.          The Recipe Management System can be  run from DOS by executing the
  100.          RECIPE.EXE file. If the subdirectory  you installed it in isn't in
  101.          your PATH,  move to the subdirectory  prior to calling RECIPE.EXE,
  102.          OR specify the location when calling (I.E. C:\RECIPE\RECIPE).
  103.          RMS can also  be installed as a Terminate  and Stay Resident (TSR)
  104.          program so that it is available  to pop up over other DOS programs
  105.          that  may be  running by  calling  it  with a  /R parameter  (i.e.
  106.          C:\RECIPE\RECIPE /R). In it's dormant state it only occupies 6K of
  107.          memory and will swap other programs in memory out to disk when the
  108.          hot key (ALT+F1) is pressed.
  109.          RMS can also  be run under Windows by creating  a new program item
  110.          in the  window of your  choice and entering  the following in  the
  111.          program item dialog box:
  112.  
  113.             Description:       Recipe Mgmt System
  114.             Command line:      RECIPE.EXE
  115.             Working directory: C:\RECIPE  (or wherever you installed it)
  116.             Shortcut key:      None
  117.  
  118.                                       Page 2
  119.                              Recipe Management System
  120.                                   Shareware Guide
  121.  
  122.          TEST DRIVE:
  123.          When  you first  start up  RMS you  will see  the start-up  screen
  124.          welcoming you to the shareware  version. Press enter twice and you
  125.          will be in  the browser. It shows you a  screen full of recipes in
  126.          the current cookbook  in recipe name order. Use  the PgUp and PgDn
  127.          keys to navigate through the recipes one screen at a time, use the
  128.          up and down arrows to navigate one  recipe at a time. When you see
  129.          a recipe that  you want to take  a closer look at,  just press the
  130.          Enter key  and you'll be in  the recipe editor. When  you're done,
  131.          press Ctrl+Enter  (hold down the  Ctrl key while  you press Enter)
  132.          and you'll be returned to the browser.
  133.  
  134.          Along the bottom of the screen  are the F key assignments (F1-F10)
  135.          here is a brief description of their meanings:
  136.  
  137.          F1-Help
  138.          Brings up a help window that will give you information relative to
  139.          what you are currently doing.
  140.  
  141.          F2-Add (or use the Insert [Ins] Key)
  142.          Brings up  a blank recipe in  the recipe editor and  allows you to
  143.          add new recipes to the current cookbook.
  144.  
  145.          F3-Del
  146.          Deletes  the  current  recipe  (RMS  asks  for confirmation of the
  147.          deletion first).
  148.  
  149.          F4-Find
  150.          This allows you to search for something in the cookbook. It brings
  151.          up a blank recipe where you enter your search criteria. Fill in as
  152.          many  fields as  you want   and press  Ctrl+Enter to  initiate the
  153.          search. RMS  uses two periods  as a "wildcard"  so if you  want to
  154.          search for  a recipe whose  title started with  Chicken, you would
  155.          enter Chicken.. in the name field.  If you wanted to find a recipe
  156.          that  contained onions  and cheese  in the  ingredients, you would
  157.          move to the ingredient section and  type in ..onions.. on one line
  158.          and  ..cheese.. on  another. TIP:  If you  want to  find the  next
  159.          occurrence, just press Alt+N!
  160.  
  161.          F5-Order
  162.          By default the  browser is in recipe name order,  but you can also
  163.          browse the recipes in category  or main ingredient order. Once you
  164.          find  a recipe  whose main  ingredient is  Salmon for  example, by
  165.          pressing the F5 key you can bring together all of the other Salmon
  166.          recipes in the current cookbook!
  167.  
  168.          F6-Filter
  169.          A  filter  is  a  subset  of  recipes  that  satisfy  some  search
  170.          criteria. Enter your  search criteria the same as  for a Find (see
  171.          F4 above)  and RMS will search  through the cookbook and  show you
  172.          only the recipes  that meet your selection. The  number of recipes
  173.          in the filter is displayed in the top right of the window.
  174.  
  175.  
  176.  
  177.                                       Page 3
  178.                              Recipe Management System
  179.                                   Shareware Guide
  180.  
  181.          F7-Cfg
  182.          Here you can modify your RMS configuration to suit your needs. You
  183.          can specify  colors, printer ports  (or files), and  several other
  184.          things.
  185.  
  186.          F8-Book
  187.          This is where  you can change to a different  cookbook (or start a
  188.          new one). It presents you with  a list of cookbooks in the current
  189.          subdirectory  (any file  that ends  with .DAT)  and allows  you to
  190.          select one.
  191.  
  192.          F9-Shop
  193.          Once you have  marked recipes (see MARKING RECIPES  below) you can
  194.          tell RMS  to gather all  of the required  ingredients together and
  195.          print out a shopping list.
  196.  
  197.          F10-Pack
  198.          Packing  the  database  will  recover  space  occupied  by deleted
  199.          recipes.  Unlike  other  recipe  programs  however  (and even some
  200.          commercial  database products)  RMS will  reuse space  occupied by
  201.          deleted recipes when you add  new recipes. For this reason packing
  202.          really only  makes sense if  you have deleted  several recipes and
  203.          don't plan on adding any.
  204.  
  205.  
  206.          MARKING RECIPES:
  207.          If you  are interested in several  recipes for printing, exporting
  208.          or printing a shopping list, you can "Mark" them by pressing Alt+M
  209.          while in the browser. When you do, you will see a checkmark to the
  210.          left of  the recipe. The  number of recipes  currently marked will
  211.          appear in the browser window header.
  212.  
  213.  
  214.          IMPORTING/EXPORTING:
  215.          One of the  greatest features of RMS is the  ability to export and
  216.          import recipe files. If you want  to share a recipe you've created
  217.          with someone else,  mark it (Alt+M) and press  Alt+X. RMS will ask
  218.          you for a file name and then  write the recipe out as a structured
  219.          ASCII file.  You can give  this file to  another RMS user  who can
  220.          then  import  it  (Alt+I)  into  their  cookbook.  If  you  are  a
  221.          registered RMS  user, you can  also import files  that are in  the
  222.          Meal-Master format.  That means that  if you (or  anyone you trade
  223.          recipes  with) keeps  their recipes  in Meal-Master,  or you see a
  224.          recipe on a bulletin board that  is in the Meal-Master format, you
  225.          can import it directly into RMS!
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                       Page 4
  237.                              Recipe Management System
  238.                                   Shareware Guide
  239.  
  240.                                 VERSION DIFFERENCES
  241.  
  242.          NEW TO 1.51:
  243.          You can now  use Alt+U to specify either  U.S. measurements (Cups,
  244.          Tbl, Tsp  etc) or Metric (Milliliters,  Grams etc.) or use  RMS to
  245.          convert from one to the other!
  246.  
  247.          NEW TO 1.52:
  248.          1.52 is a maintenance release that fixed the following:
  249.  
  250.              1)  Errors  in  the  reported  amount  of  memory available at
  251.              startup.
  252.  
  253.              2) Problems encountered when attempting  to call from some DOS
  254.              menu programs.
  255.  
  256.              3) Wouldn't export all recipes.
  257.  
  258.          NEW TO 1.60:
  259.              1) Now uses index files to build browse rows resulting in MUCH
  260.              FASTER  browser response.  RMS 1.6  will tell  you that  index
  261.              files need  to be rebuilt the  first time you open  a cookbook
  262.              from an earlier version.
  263.  
  264.              2) Allows a  file to be specified as the  reset string so that
  265.              borders etc can be drawn  around the recipes. Example PCL file
  266.              HP3X5BOX.TXT is included that is used by HPL3X5.PDF.
  267.  
  268.              3)  Fixed  error  that  occurred  when  first  line  of search
  269.              criteria was left blank when specifying a filter.
  270.  
  271.              4)  Fixed pausing  between pages  message when  printing to  a
  272.              file.
  273.  
  274.              5)  Fixed   index  problems  on  delete   and  add  ingredient
  275.              procedures.
  276.  
  277.              6) Uses  mark buffer to  store marked recipes,  MARK field not
  278.              used  anymore (don't  have to  clear it  on exit, finds marked
  279.              records faster etc...) can't mark from the editor anymore.
  280.  
  281.              7) Enabled global reformatting (Ctrl+KG).
  282.  
  283.              8) Added accessory screen (Alt+A) to do lots of stuff:
  284.                   a) Format case
  285.                   b) Set main ingredient
  286.                   c) Reformat preparations text
  287.                   d) Compare cookbooks
  288.                   e) Print a table of contents
  289.                   f) Moved SHOW MARKED recipes here because of how
  290.                      the marked files are handled in 1.60
  291.  
  292.              9) Added Ins key to the browser to insert recipes.
  293.  
  294.  
  295.                                       Page 5
  296.                              Recipe Management System
  297.                                   Shareware Guide
  298.  
  299.          TECHNICAL STUFF:
  300.          The Recipe  Management System uses a  balanced B-Tree algorithm to
  301.          handle the storage and retrieval  tasks. Indexes are maintained in
  302.          the .IX file  that allows RMS to quickly  and efficiently find and
  303.          retrieve recipes  (if it can use  an index). If you  are searching
  304.          for  a recipe  on a  non-indexed field  RMS searches  the cookbook
  305.          sequentially (a  task that takes  decidedly longer). Unlike  other
  306.          recipe programs, RMS always maintains the order of the recipes for
  307.          you based on  their name and there is  no restriction on duplicate
  308.          names  (you  might  have  several  Beef  Stew  recipes).  RMS will
  309.          automatically  detect problems  with the  index file  (if it  gets
  310.          deleted  for  example)  and  will  automatically  rebuild  them if
  311.          needed. But  your best protection  is always BACKUP,BACKUP,BACKUP!
  312.          There are many ways to do backup your cookbooks, if you have PKZIP
  313.          or some  other file compression  program it doesn't  take long and
  314.          minimizes  the impact  on your  hard drive.  Failing this, you can
  315.          export all of  the recipes to a text file  that can be imported if
  316.          needed  (this  results  in  a   file  that  is  smaller  than  the
  317.          corresponding .DAT file) or you can have RMS back up your cookbook
  318.          for you every  time you exit (this results in  a .BAK file that is
  319.          that same  size as the  .DAT file). If  you have RMS  back up your
  320.          cookbook and  want to use  the .BAK file  follow these steps  (the
  321.          following example assumes that the cookbook name was RECIPE):
  322.  
  323.          1) Rename the  RECIPE.DAT file to X.X
  324.          2) Erase the RECIPE.IX file and rename RECIPE.BAK to RECIPE.DAT
  325.          3) Start the Recipe Management System,  it will ask if you want to
  326.             rebuild the index file, tell it yes and it will run through the
  327.             file and rebuild  the indices. Once you have  verified that the
  328.             cookbook has been recovered, you can delete the X.X file.
  329.  
  330.          The  B-Tree algorithm  has earned  a well-deserved  reputation for
  331.          speed and dependability but it's best  to be prepared. I even keep
  332.          a backup of my favorite cookbooks on separate disk in case of hard
  333.          drive failure.
  334.  
  335.                            THANK-YOU THANK-YOU THANK-YOU
  336.  
  337.          Thank you for taking the time to try the Recipe Management System.
  338.          I decided  to   write  it  after  trying   several  shareware  and
  339.          commercial  recipe  programs  and  found  them  to  be  either too
  340.          cumbersome,  too limited  or too  restrictive. It  has taken  over
  341.          1,000 hours of programming to get  RMS to this point and there are
  342.          still  more  features  I  would  like  to  add.  If  you  have any
  343.          suggestions about  features to include in  future releases, please
  344.          take  the time  to write  them down  on the following registration
  345.          form and send  them to me along with any  other comments you might
  346.          have (even if you don't want to register your copy).
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                       Page 6
  355.                              Recipe Management System
  356.                                   Shareware Guide
  357.  
  358.  
  359.  
  360.                         !!! NOTES FOR WINDOWS(c) USERS !!!
  361.  
  362.          RMS 1.60 functions  well under Windows 3.1, 3.11  (WfW), Win95 and
  363.          Win NT in the testing that I  have done (DON'T USE THE TSR FEATURE
  364.          OF COURSE!!). BUT I also have  a pure Windows version in the works
  365.          for  both 16  AND 32  bit operating  systems (as  of this  writing
  366.          [1/96] it's about 75% complete). The Windows version uses the same
  367.          .DAT recipe files that RMS for DOS uses so use the DOS version for
  368.          now and you won't lose any recipes later.
  369.  
  370.          Registrations made now WILL count  for the Windows version(s) when
  371.          they become available!!!
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       Page 7
  414.                              Recipe Management System
  415.                                   Shareware Guide
  416.  
  417.                                  =================
  418.                                  REGISTRATION FORM
  419.                                  =================
  420.  
  421.  
  422.          Please complete the following registration form:
  423.  
  424.  
  425.  
  426.          Name (please print) ______________________________________________
  427.  
  428.  
  429.          Address __________________________________________________________
  430.  
  431.  
  432.          City ___________________  St/Prov __________  Zip/Code ___________
  433.  
  434.  
  435.          Country (if not USA) __________________  Phone/FAX _______________
  436.  
  437.  
  438.  
  439.  
  440.          Comments _________________________________________________________
  441.  
  442.  
  443.          __________________________________________________________________
  444.  
  445.  
  446.          __________________________________________________________________
  447.  
  448.  
  449.          __________________________________________________________________
  450.  
  451.  
  452.          __________________________________________________________________
  453.  
  454.  
  455.          __________________________________________________________________
  456.  
  457.          Enclose $30.00 and send to:
  458.  
  459.  
  460.                               Jon T. McEwen
  461.                               P.O. Box 15619
  462.                               Seattle, Washington 98115-0619
  463.  
  464.  
  465.          If you are a CompuServe subscriber, you can register on-line by
  466.          typing GO SWREG.  The registration ID for RMS is 8689.
  467.  
  468.  
  469.          Thank-You in advance for your registration.
  470.  
  471.  
  472.                                       Page 8
  473.